home *** CD-ROM | disk | FTP | other *** search
/ NetNews Offline 2 / NetNews Offline Volume 2.iso / news / comp / sys / amiga / applications / 106 < prev    next >
Encoding:
Internet Message Format  |  1996-08-05  |  25.2 KB

  1. Path: hearst.acc.Virginia.EDU!adastra!mbs
  2. Newsgroups: comp.sys.amiga.applications
  3. From: mbs@adastra.cvl.va.us (Michael B. Smith)
  4. Subject: Re: GRn configurations problems
  5. References:  <Pine.AMI.3.91.951230163728.3517304B-100000@pppxy7.cfr.usf.edu>
  6. X-NewsReader: GRn 3.0b22 December 13, 1995
  7. MIME-Version: 1.0
  8. Content-Type: text/plain; charset=iso-8859-1
  9. Content-Transfer-Encoding: 8bit
  10. Message-ID: <mbs.468n@adastra.cvl.va.us>
  11. Date: Sun, 31 Dec 95 12:48:11 EDT
  12. Organization: Only if you insist...
  13.  
  14. In article <Pine.AMI.3.91.951230163728.3517304B-100000@pppxy7.cfr.usf.edu> "Himanshu J. Gohel" <gohel@csee.usf.edu> writes:
  15. > I'm trying to configure GRn to work with AmiTCP 4.1demo and
  16. > PPP v1.3.  But inspite of setting the required variables
  17. > (USERNAME, REALNAME, NODENAME, DOMAINNAME and ORGANIZATION)
  18. > I still can't get GRn to fire up.  It complains either:
  19. >
  20. > a. insert volume inet, or
  21. > b.  GRN Panic: couldn't start NNTP!
  22.  
  23. ???
  24.  
  25. The freeware version never refers to inet:, AFAIR.
  26.  
  27. "Can't start NNTP" happens for one of five reasons:
  28.  
  29.     no nntpserver was defined
  30.     can't open socket.library/bsdsocket.library (depending on version)
  31.     invalid hostname specified for the nntpserver
  32.     could not connect to the specified host
  33.     the nntpserver refused service
  34.  
  35. And for AmiTCP one additional reason:
  36.     couldn't allocate a signal bit
  37.  
  38. > In either case, it doesn't work.  I've created a file called
  39. > S:UUConfig which contains a large list variable in this format:
  40. >
  41. > NEWSEDITOR vi
  42. > MAILEDITOR vi
  43. > ...
  44. >
  45. > but it doesn't seem to read that either.  Can anyone help me
  46. > configure the news reader?  Thanks,
  47.  
  48. I've included something that should help below. It's rather long.
  49. Look at the "oldrequirements" node.
  50. --
  51.   //   Michael B. Smith
  52. \X/    mbs@adastra.cvl.va.us
  53.  
  54. @Database ConfigVars.guide
  55. @Author Michael B. Smith
  56. @$VER: ConfigVars.guide 1.0 (29.12.95)
  57. @Width 80
  58. @SmartWrap
  59. #@Font topaz.font 11
  60.  
  61. @Node Main "ConfigVars"
  62. @{b}ConfigVars@{ub}                                @{b}ConfigVars@{ub}
  63.  
  64.  
  65. @{b}INet:s/Config@{ub} is intended as a general purpose registry for program
  66. configuration, where those programs are TCP-stack related. As such, we document
  67. all of the variables which I-Net 225 uses.
  68.  
  69.  
  70. The user does not have to use the @{b}INet:s/Config@{ub} file for setting
  71. configuration information. All values will first be read from the program's
  72. environment, before any value in that file is checked. In order of hierarchy,
  73. the following applies:
  74.  
  75.  
  76.     a program's local environment
  77.  
  78.     the global environment
  79.  
  80.     the contents of @{b}INet:s/Config@{ub}
  81.  
  82.  
  83. If you are using any of the @{b}INetUtils@{ub}, @{b}GRn@{ub}, or @{b}GMail@{ub} programs,
  84. this information also applies to you. If your version was compiled
  85. for AmiTCP or UUCP, instead of for I-Net 225, the filename used is S:UUConfig.
  86.  
  87.  
  88. If your TCP/IP stack has been installed correctly, then you are not @{u}required@{uu} to
  89. set any values in this file. The only required settings are:
  90.  
  91.  
  92.     @{"User" link user}
  93.  
  94.  
  95.     @{"Hostname" link hostname}
  96.  
  97.  
  98. and these are set by both available TCP/IP stacks in the global environment.
  99.  
  100.  
  101. However, if you using an @{u}old@{uu} version of INetUtils (the freeware
  102. version 1.4 or before) you should read @{"this section" link oldrequirements} of
  103. this manual.
  104.  
  105.  
  106. Configuration falls into three categories: general, mail, and news. Select the
  107. button for the area in which you are interested.
  108.  
  109.  
  110.     @{"General" link configgeneral}
  111.  
  112.  
  113.     @{"Mail" link configmail}
  114.  
  115.  
  116.     @{"News" link confignews}
  117.  
  118.  
  119. There are also some configuration variables commonly used by other programs. Click
  120. @{"here" link otherstuff} for descriptions of those.
  121.  
  122.  
  123. @EndNode
  124.  
  125. @Node oldrequirements "Requirements for INetUtils 1.4 and prior"
  126.  
  127.  
  128. This is @{u}only@{uu} for @{b}old@{ub} versions of INetUtils and GRn.
  129.  
  130.  
  131. Freeware versions of INetUtils required more configuration, due to having
  132. fewer defaults defined. In general, you @{u}had@{uu} to configure these
  133. items:
  134.  
  135.  
  136.     @{u}General@{uu}
  137.  
  138.  
  139.     User
  140.  
  141.     Nodename
  142.  
  143.     Hostname
  144.  
  145.     LibDir
  146.  
  147.  
  148.     @{u}Mail@{uu}
  149.  
  150.  
  151.     SMTPMailDir
  152.  
  153.     SMTPSmarterHost
  154.  
  155.     SMTPSpoolDir
  156.  
  157.  
  158.     @{u}News@{uu}
  159.  
  160.  
  161.     NewsDir
  162.  
  163.  
  164. GRn versions prior to 3.0 also required UUSpool, @{u}only@{uu} to define
  165. where to place its logfile.
  166.  
  167.  
  168. However, this is not as bad as it may appear. Nodename should be, for all
  169. intents and purposes, the same as Hostname. The other values need only to
  170. be set once, and then can be left alone. User and Hostname should be set
  171. by your TCP/IP stack.
  172.  
  173.  
  174. Contrary to some beliefs, INetUtils does not require UUCP to be installed
  175. before. For explanations of each of these values, see the descriptive text
  176. in other places in this document.
  177.  
  178.  
  179. Thus, a simple script like that shown below, running after your network connection is
  180. active, and it will take care of any problems.
  181.  
  182.  
  183. Note that there are two scripts,
  184. the first is for AS225, the other is for AmiTCP. They differ only in
  185. selected directory locations. If you have I-Net 225, or the commercial
  186. version of INetUtils, you do not need to execute these scripts. Also note
  187. that you can "assign inet: amitcp:" and run the AS225 version just as
  188. easily as the AmiTCP version.
  189.  
  190.  
  191. It is recommended that you select a proper value for SMTPSmarterhost; however, the
  192. value below will get you running. Your network provider can tell you what the
  193. correct value is.
  194.  
  195.  
  196. AS225 script:
  197.  
  198.  
  199.     setenv libdir inet:s
  200.  
  201.     setenv uuspool inet:
  202.  
  203.     setenv nodename $hostname
  204.  
  205.     if not exists inet:mail
  206.  
  207.         makedir inet:mail
  208.  
  209.     endif
  210.  
  211.     setenv smtpmaildir inet:mail
  212.  
  213.     if not exists inet:mailspool
  214.  
  215.         makedir inet:mailspool
  216.  
  217.     endif
  218.  
  219.     setenv smtpmailspool inet:mailspool
  220.  
  221.     if "$smtpsmarterhost" eq ""
  222.  
  223.         setenv smtpsmarterhost dummy
  224.  
  225.     endif
  226.  
  227.     if "$smtpsmarterhost" eq "*$smtpsmarterhost"
  228.  
  229.         setenv smtpsmarterhost dummy
  230.  
  231.     endif
  232.  
  233.     if not exists inet:news
  234.  
  235.         makedir inet:news
  236.  
  237.     endif
  238.  
  239.     setenv newsdir inet:news
  240.  
  241.  
  242. AmiTCP script:
  243.  
  244.  
  245.     setenv libdir amitcp:db
  246.  
  247.     setenv uuspool amitcp:
  248.  
  249.     setenv nodename $hostname
  250.  
  251.     if not exists amitcp:mail
  252.  
  253.         makedir amitcp:mail
  254.  
  255.     endif
  256.  
  257.     setenv smtpmaildir amitcp:mail
  258.  
  259.     if not exists amitcp:mailspool
  260.  
  261.         makedir amitcp:mailspool
  262.  
  263.     endif
  264.  
  265.     setenv smtpmailspool amitcp:mailspool
  266.  
  267.     if "$smtpsmarterhost" eq ""
  268.  
  269.         setenv smtpsmarterhost dummy
  270.  
  271.     endif
  272.  
  273.     if "$smtpsmarterhost" eq "*$smtpsmarterhost"
  274.  
  275.         setenv smtpsmarterhost dummy
  276.  
  277.     endif
  278.  
  279.     if not exists amitcp:news
  280.  
  281.         makedir amitcp:news
  282.  
  283.     endif
  284.  
  285.     setenv newsdir amitcp:news
  286.  
  287.  
  288. @Endnode
  289.  
  290. @Node configgeneral "General Configuration"
  291.  
  292.  
  293. General configuration elements affect both news and mail, or even
  294. other aspects of the TCP stack.
  295.  
  296.  
  297. The relevant items are:
  298.  
  299.  
  300.     @{"User" link user}
  301.  
  302.  
  303.     @{"Realname" link realname}
  304.  
  305.  
  306.     @{"Nodename" link nodename}
  307.  
  308.  
  309.     @{"Domainname" link domainname}
  310.  
  311.  
  312.     @{"Hostname" link hostname}
  313.  
  314.  
  315.     @{"Logfile" link logfile}
  316.  
  317.  
  318.     @{"LibDir" link libdir}
  319.  
  320.  
  321.     @{"TimeZone" link timezone}
  322.  
  323.  
  324. @EndNode
  325.  
  326. @Node configmail "Mail Configuration"
  327.  
  328.  
  329. Mail configuration variables affect only mail. If you are not using
  330. features dealing with mail, they need not be set.
  331.  
  332.  
  333. The relevant items are:
  334.  
  335.  
  336.     @{"SMTPPost" link smtppost}
  337.  
  338.  
  339.     @{"SMTPSpoolDir" link smtpspooldir}
  340.  
  341.  
  342.     @{"SMTPMailDir" link smtpmaildir}
  343.  
  344.  
  345.     @{"SMTPRMail" link smtprmail}
  346.  
  347.  
  348.     @{"SMTPDelay" link smtpdelay}
  349.  
  350.  
  351.     @{"SMTPRoute" link smtproute}
  352.  
  353.  
  354.     @{"SMTPAlwaysQueue" link smtpalwaysqueue}
  355.  
  356.  
  357.     @{"HostAliases" link hostaliases}
  358.  
  359.  
  360.     @{"CheckUser" link checkuser}
  361.  
  362.  
  363.     @{"SmartFrom" link smartfrom}
  364.  
  365.  
  366.     @{"UUCPSendMail" link uucpsendmail}
  367.  
  368.  
  369.     @{"MailReadyCMD" link mailreadycmd}
  370.  
  371.  
  372. @EndNode
  373.  
  374. @Node confignews "News Configuration"
  375.  
  376.  
  377. News configuration variables affect only news. If you are not using features
  378. dealing with news, they need not be set.
  379.  
  380.  
  381. The relevant items are:
  382.  
  383.  
  384.     @{"NewsDir" link newsdir}
  385.  
  386.  
  387.     @{"NNTPRNews" link nntprnews}
  388.  
  389.  
  390.     @{"NNTPServer" link nntpserver}
  391.  
  392.  
  393.     @{"NNTPUserid" link nntpuserid}
  394.  
  395.  
  396.     @{"NNTPPassword" link nntppassword}
  397.  
  398.  
  399. @EndNode
  400.  
  401. @Node user "Configuration - User"
  402.  
  403.  
  404. Local Environment:    set user mbs
  405.  
  406. Global Environment:    setenv user mbs
  407.  
  408. Configuration File:    user mbs
  409.  
  410. Default:        none
  411.  
  412.  
  413. "Username" is a deprecated synonym for "user".
  414.  
  415.  
  416. @{b}User@{ub} defines the login identity of the person using the computer. It is
  417. normally set by the login program of the TCP/IP stack. @{b}User@{ub} must
  418. exist in the password file.
  419.  
  420.  
  421. @{b}User@{ub} is used by various mail and news programs to construct the From: and/or
  422. Sender: headers used for identification purposes.
  423.  
  424.  
  425. I-Net 225 requires that the uid and gid specified in @{b}INet:s/inet.config@{ub} for
  426. @{b}User@{ub} also match the entries in the password file.
  427.  
  428.  
  429. @EndNode
  430.  
  431. @Node realname "Configuration - Realname"
  432.  
  433.  
  434. Local Environment:    set realname Mondo B. Sasquatch
  435.  
  436. Global Environment:    setenv realname Mondo B. Sasquatch
  437.  
  438. Configuration File:    Realname Mondo B. Sasquatch
  439.  
  440. Default:        none
  441.  
  442.  
  443. The @{b}Realname@{ub} is the proper name by which a computer user is to be known.
  444. It is used by various mail and news programs to construct the From: and/or
  445. Sender: headers used for identification purposes.
  446.  
  447.  
  448. @EndNode
  449.  
  450. @Node nodename "Configuration - Nodename"
  451.  
  452.  
  453. Local Environment:    set nodename mycomputer
  454.  
  455. Global Environment:    setenv nodename mycomputer
  456.  
  457. Configuration File:    Nodename mycomputer
  458.  
  459. Default:        none
  460.  
  461.  
  462. Use of this is not recommended. Use @{"Hostname" link hostname} instead.
  463.  
  464.  
  465. The @{b}Nodename@{ub} is normally the first piece of the @{b}Hostname@{ub} of a computer.
  466. For example, with a @{b}Hostname@{ub} of "mycomputer.somedomain.com" the @{b}Nodename@{ub}
  467. would be "mycomputer". The @{b}Domainname@{ub} would be ".somedomain.com".
  468.  
  469.  
  470. @EndNode
  471.  
  472. @Node domainname "Configuration - Domainname"
  473.  
  474.  
  475. Local Environment:    set domainname .somedomain.com
  476.  
  477. Global Environment:    setenv domainname .somedomain.com
  478.  
  479. Configuration File:    Domainname .somedomain.com
  480.  
  481. Default:        none
  482.  
  483.  
  484. Use of this is not recommended. Use @{"Hostname" link hostname} instead.
  485.  
  486.  
  487. The @{b}Domainname@{ub} is normally the rest of the @{b}Hostname@{ub} of a computer after
  488. the @{b}Nodename@{ub}. For
  489. example, with a @{b}Hostname@{ub} of "mycomputer.somedomain.com" the @{b}Nodename@{ub} would
  490. be "mycomputer". The @{b}Domainname@{ub} would be ".somedomain.com".
  491.  
  492.  
  493. @EndNode
  494.  
  495. @Node hostname "Configuration - Hostname"
  496.  
  497.  
  498. Local Environment:    set hostname mycomputer.com
  499.  
  500. Global Environment:    setenv hostname mycomputer.com
  501.  
  502. Configuration File:    Hostname mycomputer.com
  503.  
  504. Default:        none
  505.  
  506.  
  507. Be very careful if you set this. Normally, this should be set by the
  508. TCP/IP stack, and you should not modify it.
  509.  
  510.  
  511. @{b}Hostname@{ub} is the fully qualified domain name of the current computer.
  512.  
  513.  
  514. Various programs must be able to obtain the @{b}Hostname@{ub} of the computer.
  515. They will try to do this first from the @{b}Hostname@{ub} string, next
  516. from a combination of @{b}NodeName@{ub} and @{b}DomainName@{ub}, and finally
  517. from the TCP/IP stack API call @{b}gethostname()@{ub}. If all of these
  518. fail, the programs will display an error message and terminate.
  519.  
  520.  
  521. @EndNode
  522.  
  523. @Node logfile "Configuration - Logfile"
  524.  
  525.  
  526. Local Environment:    set logfile Work:INet225-logfile
  527.  
  528. Global Environment:    setenv logfile Work:INet225-logfile
  529.  
  530. Configuration File:    logfile Work:INet225-logfile
  531.  
  532. Default I-Net 225:    INet:Logfile
  533.  
  534. Default AmiTCP:     AmiTCP:Logfile
  535.  
  536. Default UUCP:        UUSpool:Logfile
  537.  
  538.  
  539. Various pieces of information concerning status and errors are
  540. stored in the @{b}Logfile@{ub}. You should examine/flush/empty this file
  541. on a regular basis.
  542.  
  543.  
  544. If you do not want logging information stored, you may set the
  545. @{b}Logfile@{ub} to NIL:.
  546.  
  547.  
  548. @EndNode
  549.  
  550.  
  551. @Node libdir "Configuration - LibDir"
  552.  
  553.  
  554. Local Environment:    set libdir INet:s
  555.  
  556. Global Environment:    setenv libdir INet:s
  557.  
  558. Configuration File:    LibDir INet:s
  559.  
  560. Default I-Net 225:    INet:s
  561.  
  562. Default AmiTCP:     UULib:
  563.  
  564. Default UUCP:        UULib:
  565.  
  566.  
  567. The @{b}LibDir@{ub} is the directory where certain files are stored. The files are:
  568.  
  569.  
  570.     <user>.header
  571.  
  572.     <user>.signature
  573.  
  574.     news/active
  575.  
  576.  
  577. The various mail and news programs will search for these files in that
  578. directory.
  579.  
  580.  
  581. @EndNode
  582.  
  583. @Node organization "Configuration - Organization"
  584.  
  585.  
  586. Local Environment:    set organization Not here, not ever.
  587.  
  588. Global Environment:    setenv organization Not here, not ever.
  589.  
  590. Configuration File:    Organization Not here, not ever.
  591.  
  592. Default:        none
  593.  
  594.  
  595. @{b}Organization@{ub} is an optional header for mail and news messages. If
  596. defined, the various mail and news programs will include this string
  597. as that header.
  598.  
  599.  
  600. It typically denotes a company affiliation.
  601.  
  602.  
  603. @EndNode
  604.  
  605. @Node newsdir "Configuration - NewsDir"
  606.  
  607.  
  608. Local Environment:    set newsdir INet:News
  609.  
  610. Global Environment:    setenv newsdir INet:News
  611.  
  612. Configuration File:    NewsDir INet:News
  613.  
  614. Default I-Net 225:    INet:News
  615.  
  616. Default AmiTCP:     AmiTCP:News
  617.  
  618. Default UUCP:        UUNews:
  619.  
  620.  
  621. @{b}NewsDir@{ub} is where transferred news articles are stored.
  622.  
  623.  
  624. @EndNode
  625.  
  626. @Node nntprnews "Configuration - NNTPRnews"
  627.  
  628.  
  629. Local Environment:    set nntprnews uucp:c/news -p
  630.  
  631. Global Environment:    setenv nntprnews uucp:c/rnews -p
  632.  
  633. Configuration File:    NNTPRNews uucp:c/rnews -p
  634.  
  635. Default:        none
  636.  
  637.  
  638. @{b}NNTPxfer@{ub} supports a configuration variable named @{b}NNTPRNEWS@{ub}. When
  639. defined, @{b}NNTPxfer@{ub} will call that program, with each incoming news
  640. article on standard input, and allow it to file that article. This
  641. allows the input to be filed along with UUCP news, and vice versa.
  642.  
  643.  
  644. For example, to be used with the AmigaUUCP RNEWS, the definition
  645. would be:
  646.  
  647.  
  648.     SetEnv NNTPRNews uucp:c/rnews -p
  649.  
  650.  
  651. with the -p indicating that this is a "postnews" call. Note that for
  652. maximum speed and efficiency, RNEWS should be a resident program.
  653.  
  654.  
  655. If the BATCH parameter is set for @{b}NNTPXfer@{ub}, then the correct setting would be:
  656.  
  657.  
  658.     SetEnv NNTPRNews uucp:c/rnews
  659.  
  660.  
  661. since more than one article will be contained in the input to RNEWS.
  662. Using the BATCH mode is much more efficient for a large feed than
  663. otherwise.
  664.  
  665.  
  666. @EndNode
  667.  
  668. @Node nntpserver "Configuration - NNTPServer"
  669.  
  670.  
  671. Local Environment:    set nntpserver news.somedomain.com
  672.  
  673. Global Environment:    setenv nntpserver news.somedomain.com
  674.  
  675. Configuration File:    NNTPServer news.somedomain.com
  676.  
  677. Default:        none
  678.  
  679.  
  680. To transfer articles via NNTP (Network News Transfer Protocol) requires
  681. that they be obtained from another computer. That other computer is the
  682. @{b}NNTPServer@{ub}.
  683.  
  684.  
  685. Your network provider will have to tell you the correct value to set
  686. for the @{b}NNTPServer@{ub}.
  687.  
  688.  
  689. @EndNode
  690.  
  691. @Node nntpuserid "Configuration - NNTPUserid"
  692.  
  693.  
  694. Local Environment:    set nntpuserid mbs
  695.  
  696. Global Environment:    setenv nntpuserid mbs
  697.  
  698. Configuration File:    NNTPUserid mbs
  699.  
  700. Default:        none
  701.  
  702.  
  703. Most network providers will not allow anonymous or unauthorized access
  704. to their NNTP server. Using the @{b}NNTPUserid@{ub} and @{b}NNTPPassword@{ub} configuration variables
  705. allows you to identify yourself to the NNTP server, based on the
  706. "AUTHINFO USER" protocol.
  707.  
  708.  
  709. Your network provider will assign you a @{b}NNTPUserid@{ub} and an @{b}NNTPPassword@{ub}.
  710.  
  711.  
  712. @EndNode
  713.  
  714. @Node nntppassword "Configuration - NNTPPassword"
  715.  
  716.  
  717. Local Environment:    set nntppassword somepassword
  718.  
  719. Global Environment:    setenv nntppassword somepassword
  720.  
  721. Configuration File:    NNTPPassword somepassword
  722.  
  723. Default:        none
  724.  
  725.  
  726. Most network providers will not allow anonymous or unauthorized access
  727. to their NNTP server. Using the @{b}NNTPUserid@{ub} and @{b}NNTPPassword@{ub} configuration variables
  728. allows you to identify yourself to the NNTP server, based on the
  729. "AUTHINFO USER" protocol.
  730.  
  731.  
  732. Your network provider will assign you a @{b}NNTPUserid@{ub} and an @{b}NNTPPassword@{ub}.
  733.  
  734.  
  735. @EndNode
  736.  
  737. @Node smtppost "Configuration - SMTPPost"
  738.  
  739.  
  740. Local Environment:    set smtppost INet:c/smtppost
  741.  
  742. Global Environment:    setenv smtppost INet:c/smtppost
  743.  
  744. Configuration File:    SMTPPost INet:c/SMTPPost
  745.  
  746. Default:        SMTPpost
  747.  
  748.  
  749. Setting this allows you to identify where the @{b}SMTPPost@{ub} binary
  750. resides, if it is not in your default path.
  751.  
  752.  
  753. @EndNode
  754.  
  755. @Node smtpspooldir "Configuration - SMTPSpoolDir"
  756.  
  757.  
  758. Local Environment:    set smtpspooldir INet:MailSpool
  759.  
  760. Global Environment:    setenv smtpspooldir INet:MailSpool
  761.  
  762. Configuration File:    SMTPSpoolDir INet:MailSpool
  763.  
  764. Default I-Net 225:    INet:MailSpool
  765.  
  766. Default AmiTCP:     AmiTCP:MailSpool
  767.  
  768.  
  769. @{b}SMTPSpoolDir@{ub} is the directory where SMTP spool files are to be
  770. located. If @{b}SMTPpost@{ub} cannot locate a destination host, it places
  771. the articles in this directory, and retries sending the messages on
  772. a regular basis. It @{u}may not@{uu} be shared with the UUCP spool directory, as the batch
  773. files are of a different format.
  774.  
  775.  
  776. This directory must exist.
  777.  
  778.  
  779. @EndNode
  780.  
  781. @Node smtpmaildir "Configuration - SMTPMailDir"
  782.  
  783.  
  784. Local Environment:    set smtpmaildir INet:Mail
  785.  
  786. Global Environment:    setenv smtpmaildir INet:Mail
  787.  
  788. Configuration File:    SMTPMailDir INet:Mail
  789.  
  790. Default I-Net 225:    INet:Mail
  791.  
  792. Default AmiTCP:     AmiTCP:Mail
  793.  
  794. Default UUCP:        UUMail:
  795.  
  796.  
  797. The directory where local mail is to be stored. This directory must
  798. exist.
  799.  
  800.  
  801. This directory may be shared with UUCP mailboxes and folders.
  802.  
  803.  
  804. @EndNode
  805.  
  806. @Node smtpsmarterhost "Configuration - SMTPSmarterHost"
  807.  
  808.  
  809. Local Environment:    set smtpsmarterhost dummy
  810.  
  811. Global Environment:    setenv smtpsmarterhost dummy
  812.  
  813. Configuration File:    SMTPSmarterHost dummy
  814.  
  815. Default:        none
  816.  
  817.  
  818. @{b}SMTPSmarterHost@{ub} is a SMTP host where mail is sent if a destination
  819. host named in an address is not reachable. It is presumed to be an
  820. Internet host which has better routing information than does the host
  821. running this @{b}SMTPd@{ub}. If not specified, no smarterhost routing will
  822. be done.
  823.  
  824.  
  825. @EndNode
  826.  
  827. @Node smtprmail "Configuration - SMTPRMail"
  828.  
  829.  
  830. Local Environment:    set smtprmail uucp:c/sendmail -r
  831.  
  832. Global Environment:    setenv smtprmail uucp:c/sendmail -r
  833.  
  834. Configuration File:    SMTPRMail uucp:c/sendmail -r
  835.  
  836. Default:        SMTPPost -r
  837.  
  838.  
  839. @{b}SMTPRMail@{ub} defines the program that will deliver mail which was
  840. destined for this host. Typically, it is a copy of @{b}SMTPpost@{ub}, renamed
  841. to RSMTP or SMTPpost with the -r argument.
  842.  
  843.  
  844. @EndNode
  845.  
  846. @Node smtpdelay "Configuration - SMTPDelay"
  847.  
  848.  
  849. Local Environment:    set smtpdelay 30
  850.  
  851. Global Environment:    setenv smtpdelay 30
  852.  
  853. Configuration File:    SMTPDelay 30
  854.  
  855. Default:        120
  856.  
  857.  
  858. @{b}SMTPd@{ub} uses the @{b}SMTPDelay@{ub} environment variable to determine how long
  859. to wait between scans of @{b}SMTPSpoolDir@{ub}. The
  860. default value causes @{b}SMTPd@{ub} to wait two minutes between each scan of the
  861. spool directory. Note that @{b}SMTPd@{ub} will not try to ship a specific
  862. file more often than two times @{b}SMTPDelay@{ub}. That is, for the default,
  863. a file will not be attempted more often than once every four minutes.
  864.  
  865.  
  866. @EndNode
  867.  
  868. @Node smtproute "Configuration - SMTPRoute"
  869.  
  870.  
  871. Local Environment:    set smtproute mx,smtp
  872.  
  873. Global Environment:    setenv smtproute mx,smtp
  874.  
  875. Configuration File:    SMTPRoute mx,smtp
  876.  
  877. Default:        mx,smtp,smarterhost,uucp
  878.  
  879.  
  880. @{b}SMTPRoute@{ub} may have any of four values, comma or space separated.
  881. The values are:
  882.  
  883.  
  884.     MX
  885.  
  886.     SMTP
  887.  
  888.     SmarterHost
  889.  
  890.     UUCP
  891.  
  892.  
  893. These values control the way @{b}SMTPpost@{ub} attempts to deliver mail to
  894. remote hosts.
  895.  
  896.  
  897. MX indicates to use the MX record (from DNS) to deliver the mail
  898. to the destination host via the forwarding host specified in the
  899. MX record.
  900.  
  901.  
  902. SMTP indicates to attempt to deliver the mail directly to the
  903. remote host.
  904.  
  905.  
  906. SmarterHost indicates to deliver the mail to the host specified
  907. as the @{b}SMTPSmarterHost@{ub} configuration variable. If @{b}SMTPSmarterHost@{ub} is
  908. not specified, then this type of transfer will not occur, and
  909. a warning will be issued if Smarterhost is specified.
  910.  
  911.  
  912. UUCP indicates to deliver the mail using the mail program specified
  913. as the @{b}UUCPSendMail@{ub} configuration variable. If @{b}UUCPSendMail@{ub} is not
  914. specified, then this type of transfer will not occur, and a warning
  915. will be issued if UUCP is specified.
  916.  
  917.  
  918. Note: the freeware version of @{b}SMTPpost@{ub} in INetUtils 1.4 only utilized the first
  919. MX record for any destination host.
  920.  
  921.  
  922. @EndNode
  923.  
  924. @Node smtpalwaysqueue "Configuration - SMTPAlwaysQueue"
  925.  
  926.  
  927. Local Environment:    set smtpalwaysqueue y
  928.  
  929. Global Environment:    setenv smtpalwaysqueue y
  930.  
  931. Configuration File:    SMTPAlwaysQueue yes
  932.  
  933. Default:        no
  934.  
  935.  
  936. When set to "yes", then @{b}SMTPpost@{ub} will act as if -Q was passed.
  937. The default is "no".
  938.  
  939.  
  940. When set, @{b}SMTPpost@{ub} will not attempt to deliver mail directly,
  941. but will allow @{b}SMTPd@{ub} to process the mail as part of it's regular
  942. cycle.
  943.  
  944.  
  945. This has the advantage of crash protection -- if a mail message does
  946. not go through @{b}SMTPd@{ub}, then it may reside only in memory. If the computer
  947. crashes for any reason while @{b}SMTPPost@{ub} is processing a message, then it
  948. is "lost". If it is queued on disk, then it will still exist, and will
  949. be reprocessed later.
  950.  
  951.  
  952. @EndNode
  953.  
  954. @Node hostaliases "Configuration - HostAliases"
  955.  
  956.  
  957. Local Environment:    set hostaliases othercomputer.com
  958.  
  959. Global Environment:    setenv hostaliases othercomputer.com
  960.  
  961. Configuration File:    HostAliases othercomputer.com
  962.  
  963. Default:        none
  964.  
  965.  
  966. The @{b}HostAliases@{ub} variable contains other hostnames which are the
  967. local host. For example, if your host is "x.y.z", but you also
  968. need to accept mail to "zz.zz" as local to you, you should set
  969. that in @{b}HostAliases@{ub}.
  970.  
  971.  
  972. In general, put "localhost,[ip.address],ip.address" plus any
  973. others into @{b}HostAliases@{ub}.
  974.  
  975.  
  976. The comparison is *not* case sensitive.
  977.  
  978.  
  979. Note: The freeware version of @{b}SMTPpost@{ub} in INetUtils 1.4 only allowed two entries in @{b}Hostaliases@{ub}.
  980.  
  981.  
  982. @EndNode
  983.  
  984. @Node smartfrom "Configuration - SmartFrom"
  985.  
  986.  
  987. Local Environment:    set smartfrom y
  988.  
  989. Global Environment:    setenv smartfrom y
  990.  
  991. Configuration File:    SmartFrom yes
  992.  
  993. Default:        no
  994.  
  995.  
  996. The very first line of a mail message is the envelope. This
  997. option controls the format of the envelope. Normally, it
  998. looks like this (with "SmartFrom no"):
  999.  
  1000.  
  1001.     From mbs Sat Jul 1 1995 17:42:12 (EST) remote from mycomputer.com
  1002.  
  1003.  
  1004. and with "SmartFrom yes", it looks like this:
  1005.  
  1006.  
  1007.     From mbs@mycomputer.com Sat Jul 1 1995 17:42:12 (EST)
  1008.  
  1009.  
  1010. which is relevant to some mail readers (but very few).
  1011.  
  1012.  
  1013. Note that this is @{u}not@{uu} the same thing as the "From:" header.
  1014.  
  1015.  
  1016. "SmartUUCP" is a deprecated synonym for @{b}SmartFrom@{ub}.
  1017.  
  1018.  
  1019. @EndNode
  1020.  
  1021. @Node checkuser "Configuration - CheckUser"
  1022.  
  1023.  
  1024. Local Environment:    set checkuser INet:c/checkuser
  1025.  
  1026. Global Environment:    setenv checkuser INet:c/checkuser
  1027.  
  1028. Configuration File:    CheckUser INet:c/CheckUser
  1029.  
  1030. Default:        none
  1031.  
  1032.  
  1033. The @{b}CheckUser@{ub} variable defines a program which is executed for
  1034. each piece of incoming mail to validate whether the destination user actually
  1035. exists. To wit:
  1036.  
  1037.  
  1038.         CheckUser userid
  1039.  
  1040.  
  1041. @{b}SMTPpost@{ub} checks the first character of standard output from the
  1042. program (stdout). If it is a '*', then the user is deemed invalid.
  1043. Any other output is defined as the fully-specified filename to
  1044. be used as the mailbox for the destination user.
  1045.  
  1046.  
  1047. Note: this feature is not available in the freeware version of
  1048. @{b}SMTPpost@{ub} in INetUtils 1.4.
  1049.  
  1050.  
  1051. @EndNode
  1052.  
  1053. @Node timezone "Configuration - TimeZone"
  1054.  
  1055.  
  1056. Local Environment:    set timezone (+0400)
  1057.  
  1058. Global Environment:    setenv timezone (+0400)
  1059.  
  1060. Configuration File:    TimeZone (+0400)
  1061.  
  1062. Default:        none
  1063.  
  1064.  
  1065. When required to generate a Date: header, @{b}SMTPpost@{ub} and @{b}NNTPpost@{ub} will generate an ARPA
  1066. date-time stamp as specified in RFC-822 (and modified by
  1067. RFC-1123). This is the format:
  1068.  
  1069.  
  1070.     Wed, 13 Oct 1993 18:52:04 EST
  1071.  
  1072.  
  1073. The @{b}TimeZone@{ub} variable would contain, for example, the "EST" as
  1074. shown above.
  1075.  
  1076.  
  1077. There are relatively few "legal" timezones specified in the
  1078. RFC. Some mail systems, and similarly some news systems, will
  1079. reject a Date which does not have a legal @{b}TimeZone@{ub}. To ensure
  1080. this "legality" a @{b}TimeZone@{ub} of the form:
  1081.  
  1082.  
  1083.     (+0500)
  1084.  
  1085.  
  1086. is preferred, @{u}with@{uu} the literal parentheses. The resulting
  1087. header would be:
  1088.  
  1089.  
  1090.     Wed, 13 Oct 1993 18:52:04 (+0500)
  1091.  
  1092.  
  1093. @EndNode
  1094.  
  1095. @Node uucpsendmail "Configuration - UUCPSendMail"
  1096.  
  1097.  
  1098. Local Environment:    set uucpsendmail uucp:c/rmail
  1099.  
  1100. Global Environment:    setenv uucpsendmail uucp:c/rmail
  1101.  
  1102. Configuration File:    UUCPSendMail uucp:c/rmail
  1103.  
  1104. Default:        none
  1105.  
  1106.  
  1107. If the @{b}SMTPRoute@{ub} variable includes UUCP as a part of it, then this
  1108. variable must be defined. It defines the program name of the UUCP
  1109. mail program (typically @{b}UUCP:C/RMail@{ub}).
  1110.  
  1111.  
  1112. @EndNode
  1113.  
  1114. @Node mailreadycmd "Configuration - MailReadyCMD"
  1115.  
  1116.  
  1117. Local Environment:    set mailreadycmd
  1118.  
  1119. Global Environment:    setenv mailreadycmd
  1120.  
  1121. Configuration File:    MailReadyCMD
  1122.  
  1123. Default:        none
  1124.  
  1125.  
  1126. @{b}SMTPpost@{ub} will attempt to run a command named by the
  1127. @{b}MailReadyCMD@{ub} configuration variable when delivering @{u}local@{uu} mail. The format of the
  1128. command is:
  1129.  
  1130.  
  1131.     MAILREADYCMD -x T:MailRdy
  1132.  
  1133.  
  1134. @{b}SMTPpost@{ub} will also cause the signal of a public message port named
  1135. "T:MailRdy" if it can be found.
  1136.  
  1137.  
  1138. @EndNode
  1139.  
  1140. @Node otherstuff "Configuration - Other Variables"
  1141.  
  1142.  
  1143. Other programs also use configuration information in the way described in this document. Here
  1144. are some common items used.
  1145. @{lindent 5}
  1146.  
  1147.  
  1148. ReplyTo
  1149. @{lindent 10}
  1150.  
  1151.  
  1152. Defines the address that an email reply to an email message or news article
  1153. should be sent to. For example:
  1154.  
  1155.  
  1156.     set ReplyTo mbs@somedomain.com
  1157. @{lindent 5}
  1158.  
  1159.  
  1160. WWW_Home
  1161. @{lindent 10}
  1162.  
  1163.  
  1164. The "Home Page" that should be accessed when a user clicks on the "Home" button
  1165. in a Web browser.
  1166. @{lindent 5}
  1167.  
  1168.  
  1169. HTTP_Proxy
  1170. @{lindent 10}
  1171.  
  1172.  
  1173. In order to get through a firewall, many users have to redirect World Wide Web
  1174. requests. This one allows a HTTP request to be redirected.
  1175. @{lindent 5}
  1176.  
  1177.  
  1178. FTP_Proxy
  1179. @{lindent 10}
  1180.  
  1181.  
  1182. In order to get through a firewall, many users have to redirect World Wide Web
  1183. requests. This one allows a FTP request to be redirected.
  1184. @{lindent 5}
  1185.  
  1186.  
  1187. GOPHER_Proxy
  1188. @{lindent 10}
  1189.  
  1190.  
  1191. In order to get through a firewall, many users have to redirect World Wide Web
  1192. requests. This one allows a Gopher request to be redirected.
  1193. @{lindent 5}
  1194.  
  1195.  
  1196. PopHost
  1197. @{lindent 10}
  1198.  
  1199.  
  1200. Some POP-mail clients use PopHost to the define the computer to access
  1201. to get POP mail.
  1202. @{lindent 5}
  1203.  
  1204.  
  1205. PopUser
  1206. @{lindent 10}
  1207.  
  1208.  
  1209. Some POP-mail clients use PopUser as the authorization name sent
  1210. to the POP host.
  1211. @{lindent 5}
  1212.  
  1213.  
  1214. PopPassword
  1215. @{lindent 10}
  1216.  
  1217.  
  1218. Some POP-mail clients use PopPassword as the password for "PopUser".
  1219.  
  1220.  
  1221. @EndNode
  1222.  
  1223.